AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu
Docs Home
/ /
インストール
Docs Home
/
ツール
/
SQLインターフェース
/
インストール
Docs Home
/
ツール
/
SQLインターフェース
/
インストール

SQLツールをMongoDBに接続する

Connect your SQL tool, such as Tableau, Power BI, or DBeaver to your MongoDB Atlas or Enterprise Advanced (EA) database.

All three SQL Interface deployment options use the same JDBC and ODBC drivers, so the steps on this page are the same whether you connect to an Atlas dedicated cluster, an Atlas federated database instance, or a self-managed Enterprise Advanced (EA) deployment. Configure your deployment to accept SQL connections first. To learn how, see SQL Interface Server Setup.

注意

MongoDB officially supports Tableau (Desktop, Server, or Cloud) and Power BI Desktop (Desktop and Service) with its JDBC and ODBC drivers. You can use the JDBC and ODBC drivers with other SQL-92 compatible tools, but MongoDB cannot guarantee compatibility. Test your specific SQL Interface features to confirm support.

Tableau の接続

Connect an Atlas dedicated cluster, an Atlas federated database instance, or a self-hosted Enterprise Advanced (EA) database to Tableau (Desktop or Server) using the Tableau Connector for MongoDB.

前提条件

手順

次の手順は、 Tableauを使用してMongoDBに接続する方法を示しています。

1

Tableau Connector for MongoDBをダウンロードします。

注意

Tableau Desktop および Tableau サーバー バージョン 2025 以降には、MongoDB 用の Connector がバンドルされています。お使いの Tableau のバージョンに既に Connector が含まれている場合は、この手順をスキップしてください。Tableau にバンドルされているバージョンとは異なるバージョンを使用する場合は、この手順を完了してください。

Tableau Desktopの場合は、Tableauからコネクタをインストールすることもできます。Tableau ExchangeでMongoDB SQL interface by MongoDBを検索し、Install and restart Tableauをクリックします。

  1. Download the latest Tableau Connector taco file from the MongoDB download center.

  2. tacoファイルをオペレーティング システムの適切なディレクトリに移動します。

    • Windows: C:\Users\<user>\Documents\My Tableau Repository\Connectors

    • MacOS: ~/Documents/My Tableau Repository/Connectors

    • Linux: /opt/tableau/connectors

重要

Tableau Connector for MongoDBの新しいバージョンをダウンロードする場合は、Connectorsディレクトリから前の tacoファイルを削除して、 Tableau が最新バージョンを使用していることを確認します。

2

MongoDBデータベース接続情報を取得します。

接続情報を取得する方法については、ご使用の配置タイプのタブを選択してください。

  1. Go to プロジェクトのAtlas専有クラスターまたはフェデレーティッドデータベースインスタンス。

  2. [Connect] をクリックします。

  3. Atlas SQL Interface オプションを選択します。

  4. Tableau Connector[1]Select your driver ドロップダウンで [] オプションを選択します。

  5. ドロップダウンから [Tableau] を選択します。

  6. Database ドロップダウンから接続するデータベースを選択します。

  7. 接続文字列と接続パラメーターをコピーします。

    この情報を使用して、後のステップでTableauに接続します。

3

Tableau Desktop または Tableau Server を開きます。

4

Connect メニューにGo。

5

MongoDB SQL Interface by MongoDB を選択します。

接続モーダルが表示されます。

6

データベース接続情報を入力します。

前の手順で保存したSQL Interface接続文字列を入力します。

7

認証方法を選択します。

ドロップダウンから Authentication Mechanism を選択します。

サポートされているすべての認証メカニズムの詳細については、 SQLインターフェイス認証 を参照してください。

  • Username: MongoDBユーザー名を入力します。

  • Password: MongoDBのパスワードを入力します。

8

[Sign In] をクリックします。

Tableau ログ設定

MongoDB JDBC ドライバーのログ設定を変更するには、mongodb_jdbc.properties ファイルにログ プロパティを追加します。このファイルのロケーションはプラットフォームによって異なります。

プラットフォーム
パス

MacOS

~/Documents/My Tableau Repository/Datasources/mongodb_jdbc.properties
~/Documents/My Tableau Prep Repository/Datasources/mongodb_jdbc.properties

Windows

C:\Users\<username>\Documents\My Tableau Repository\Datasources\mongodb_jdbc.properties
C:\Users\<username>\Documents\My Tableau Prep Repository\Datasources\mongodb_jdbc.properties

Tableau サーバー (RHEL)

/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/mongodb_jdbc.properties

このファイルをすべてのサーバーノードにコピーします。

ロギングを構成するには、次のプロパティをファイルに追加してください。

loglevel=INFO
logdir=<path-to-log-directory>

loglevel プロパティは、ドライバーログの冗長を設定します。冗長性が高い順に、OFF、SEVERE、WARNING、INFO、FINE、FINER の値を受け入れます。デフォルトは OFF です。

logdir プロパティは、ドライバーがログファイルを書き込み (write)するディレクトリを設定します。ディレクトリは既に存在している必要があります。logdir を省略するか、console に設定すると、ドライバーはファイルではなくコンソールにログを書き込み (write)ます。

重要

本番環境では、SEVERE ログレベルから開始してください。各レベルで大量の出力が追加されるため、問題を診断する必要がある場合にのみレベルを上げてください。FINER レベルでは、ドライバーは各結果セットの各セルのデータを検索するすべての呼び出しをログに記録します。

Tableau でのプロパティ ファイルについて詳しく学ぶには、Tableau ドキュメントを参照してください。

Power BIの接続

Connect an Atlas dedicated cluster, an Atlas federated database instance, or a self-hosted Enterprise Advanced (EA) database to Power BI using the Power BI Connector for MongoDB.

前提条件

  • MongoDB ODBC ドライバー。をインストールするには、 「 SQLインターフェイスドライバーの設定 」を参照してください。 Direct Query 1を使用するには、バージョン.2 以降をインストールする必要があります。

  • Power BI Desktop 64 ビット。Microsoft は Power BI を毎月更新およびリリースしています。Atlas では最新バージョンの Power BI Desktop のみをサポートしています。

  • Windowsオペレーティング システム。Power BI Desktop がサポートする Windows OS のバージョンについては、Microsoft のドキュメント を参照してください。

手順

次の手順は、 Power BIを使用してMongoDBに接続する方法を示しています。

1

Power BI Connector for MongoDBをダウンロードします。

  1. Download the latest Power BI Connector pqx file from the MongoDB download center.

    注意

    Power BI Connector for MongoDBは、Power BI Desktop に付属します。お使いの Power BI Desktop のバージョンに既にMongoDB Atlas SQL コネクタがある場合は、この手順をスキップします。Power BI Desktop にバンドルされているバージョンとは異なるバージョンを使用する場合に、この手順を完了します。

  2. コネクタファイルを次のディレクトリパスに移動します。

    C:\Users\<user>\Documents\Power BI Desktop\Custom Connectors.

    このフォルダが存在しない場合は作成します。

2

MongoDBデータベース接続情報を取得します。

接続情報を取得する方法については、ご使用の配置タイプのタブを選択してください。

  1. Go to プロジェクトのAtlas専有クラスターまたはフェデレーティッドデータベースインスタンス。

  2. Connectボタンをクリックします。

  3. Atlas SQL Interface オプションを選択します。

  4. Power BI Connector[1]Select your driver ドロップダウンで [] オプションを選択します。

  5. 接続文字列をコピーします。

    この情報は、後のステップでPower BIに接続する際に使用します。

3

Power BI Desktop から接続します。

  1. Power BI Desktop を開きます。

  2. Home メニューから Get data を選択します。

  3. MongoDB Atlas SQL connector を見つけて選択します。

    1. 新しいconnectorを見つけるには、検索バーに mongo と入力します。

    2. MongoDB Atlas SQL を選択します。

    3. [Connect] をクリックします。

  4. URI とデータベース名を入力し、OK をクリックします。

    MongoDB URI は、前のステップでコピーした接続文字列です。

    Native query フィールドには、オプションで SQL クエリを入力できます。Power BI は、SQL クエリを直接のデータソースとして使用します。接続後に Power Query エディターで SQL クエリを追加または変更することもできます。

  5. Atlas User name と Password を入力し、Connect をクリックします。

    By default, users can access all namespaces that their roles and connection URI permit. If you use custom roles to restrict access, you can grant users access to additional namespaces in the Edit User menu. To learn more, see Configure Database Users.

    サポートされている他の認証メカニズムの詳細については、 SQLインターフェイス認証 を参照してください。

Direct Query

Direct Query is a connection mode available with the Power BI Connector for MongoDB version 1.2 and later. To use Direct Query, you must install MongoDB ODBC Driver version 1.2 or later. You don't need to configure a DSN.

Direct Query は、標準の Import モード の代わりに使用でき、データベースに直接クエリを実行できます。これにより、最新のデータが保証されますが、結果が返されるまでに時間がかかる場合があります。

直接クエリは一部のアクションをサポートしていません。 サポートされていないアクションを実行しようとすると、Power BIImport Mode に切り替えるよう求めるメッセージが表示されます。

DBeaver の接続

MongoDB JDBC ドライバー を使用して、 Atlas専有クラスター、 Atlasフェデレーティッドデータベースインスタンス、または自己管理型Enterprise Advanced（EA）配置を DBeaver に接続します。

前提条件

手順

DBeaver から接続するには、次の手順に従います。

1

MongoDBデータベース接続情報を取得します。

接続情報を取得する方法については、ご使用の配置タイプのタブを選択してください。

  1. Go to プロジェクトのAtlas専有クラスターまたはフェデレーティッドデータベースインスタンス。

  2. Connectボタンをクリックします。

  3. Atlas SQL Interface オプションを選択します。

  4. JDBC Driver[1]Select your driver ドロップダウンで [] オプションを選択します。

  5. Database ドロップダウンから接続するデータベースを選択します。

  6. 接続文字列をコピーします。

    この情報は、後のステップでDBeaverに接続する際に使用します。

2

DBeaverアプリケーションを開きます。

3

DBeaver にドライバーを追加します。

  1. DBeaver で、Database をクリックし、ドロップダウン メニューから Driver Manager を選択します。

  2. New をクリックすると Create new driver モーダルが開きます。

  3. Settingsタブで、次の情報を指定します。

    ドライバー名

    MongoSQL

    クラス名

    com.mongodb.jdbc.MongoDriver

  4. Libraries タブで、Add File をクリックし、JDBC ドライバー all.jar ファイルを追加します。

    [Find Class] をクリックします。

  5. OK をクリックします。Create new driver モーダルが閉じます。

4

データベース接続を作成します。

  1. DBeaver で、Database をクリックし、ドロップダウン メニューから New Database Connection を選択して、Connect to a database モーダルを開きます。

  2. データベースのリストから、前の手順で作成した MongoDB データベース ドライバーを選択します。

    MongoDB が表示されない場合は、モーダル内で All カテゴリを選択してください。

    [Next] をクリックします。

  3. Main タブで、次の情報を入力します。

    JDBC URL

    前のステップから取得された接続文字列。

    ユーザー名

    接続を許可されたMongoDBユーザー。

    パスワード

    MongoDBユーザーに関連付けられたパスワード

  4. Driver properties タブで、User Properties を展開します。次のキーと値のプロパティを追加します。

    database

    仮想データベースの名前。

    user

    接続する MongoDB ユーザー。前の手順で Username を入力した場合は不要です。

次のステップ

SQLツールをMongoDBデータベースに接続したら、データをクエリできるようになります。より多くを学ぶには、以下を参照してください。

注意

プライベートエンドポイントを使用して接続するには、「プライベートエンドポイントを使用したMongoDB SQLインターフェースへの接続」を参照してください。

戻る
ドライバーを設定する
次へ
クエリ
このページを評価

項目一覧